Apache ActiveMQ ™ -- Destination Options

Features > Destination Features > Destination Options

Background

Destination Options are a way to provide extended configuration options to a JMS consumer without having to extend the JMS API. The options are encoded using URL query syntax in the destination name that the consumer is created on.

Consumer Options

Option Name

Default Value

Description

consumer.dispatchAsync

true

Should the broker dispatch messages asynchronously to the consumer.

consumer.exclusive

false

Is this an Exclusive Consumer.

consumer.maximumPendingMessageLimit

0

Use to control if messages for non-durable topics are dropped if a slow consumer situation exists.

consumer.noLocal

false

Same as the noLocal flag on a Topic consumer. Exposed here so that it can be used with a queue.

consumer.prefetchSize

n/a

The number of message the consumer will prefetch.

consumer.priority

0

Allows you to configure a Consumer Priority.

consumer.retroactive

false

Is this a Retroactive Consumer.

consumer.selector

null

JMS Selector used with the consumer.

Example

queue = new ActiveMQQueue("TEST.QUEUE?consumer.dispatchAsync=false&consumer.prefetchSize=10"); consumer = session.createConsumer(queue);